package com.ruoyi.module.mapper;

import java.util.List;

import com.ruoyi.module.domain.DictWord;

/**
 * 词典单词Mapper接口
 * 
 * @author ruoyi
 */
public interface DictWordMapper 
{
    /**
     * 查询词典单词
     * 
     * @param id 词典单词主键
     * @return 词典单词
     */
    public DictWord selectDictWordById(Long id);

    /**
     * 查询词典单词列表
     * 
     * @param dictWord 词典单词
     * @return 词典单词集合
     */
    public List<DictWord> selectDictWordList(DictWord dictWord);

    /**
     * 查询词典单词列表（带词典名称和标签）
     * 
     * @param dictWord 词典单词
     * @return 词典单词集合
     */
    public List<DictWord> selectDictWordListWithTags(DictWord dictWord);

    /**
     * 根据词典ID查询单词列表
     * 
     * @param bookId 词典ID
     * @return 词典单词集合
     */
    public List<DictWord> selectDictWordListByBookId(String bookId);

    /**
     * 根据单词查询
     * 
     * @param word 单词
     * @param bookId 词典ID（可选）
     * @return 词典单词集合
     */
    public List<DictWord> selectDictWordByWord(String word, String bookId);

    /**
     * 新增词典单词
     * 
     * @param dictWord 词典单词
     * @return 结果
     */
    public int insertDictWord(DictWord dictWord);

    /**
     * 批量新增词典单词
     * 
     * @param dictWords 词典单词列表
     * @return 结果
     */
    public int batchInsertDictWord(List<DictWord> dictWords);

    /**
     * 修改词典单词
     * 
     * @param dictWord 词典单词
     * @return 结果
     */
    public int updateDictWord(DictWord dictWord);

    /**
     * 删除词典单词
     * 
     * @param id 词典单词主键
     * @return 结果
     */
    public int deleteDictWordById(Long id);

    /**
     * 批量删除词典单词
     * 
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteDictWordByIds(Long[] ids);

    /**
     * 根据词典ID删除所有单词
     * 
     * @param bookId 词典ID
     * @return 结果
     */
    public int deleteDictWordByBookId(String bookId);

    /**
     * 统计词典单词数量
     * 
     * @param bookId 词典ID
     * @return 单词数量
     */
    public int countWordsByBookId(String bookId);
}

